MSVC Solution/README - MSVC.txt

   1 This solution for Microsoft's Visual Studio 2005 and higher has been configured to be as easy as possible to set up. \r
   2 \r
   3 However, given the size of the aMule project and the libraries it uses, along with limitations in the way Visual Studio works,\r
   4 a couple of items must be setup separately. Additionally, some source code files might need patching due to incompatibilities \r
   5 with some generated files. \r
   6 \r
   7 The solution expects to find the following items:\r
   8 \r
   9 * wxWidgets ( http://www.wxwidgets.org ) at a specific location: ..\..\wxWidgets\ from the solution directory.\r
  10 * zlib ( http://www.zlib.net ) at a specific location: ..\..\zlib\ from the solution directory.\r
  11 * crypto++ ( http://www.cryptopp.com/ ) at a specific location: ..\..\cryptopp\ from the solution directory.\r
  12 \r
  13 \r
  14 This means you must create a folder where you will compile aMule, and it must have this structure:\r
  15 \r
  16 - <Root folder> - Your main folder. You can name it whatever you want.\r
  17  | \r
  18  | - wxWidgets ( wxWidgets sources, no intermediate subfolder )\r
  19  |\r
  20  | - zlib ( zlib sources, no intermediate subfolder )\r
  21  |\r
  22  | - cryptopp ( Crypto++ sources, no intermediate subfolder )\r
  23  |\r
  24  | - <amule-sources> ( aMule sources, no intermediate subfolder, can have any name )\r
  25 \r
  26 \r
  27 I hope this is simple enough to get you started. \r
  28 \r
  29 If wxWidgets fails to compile, please read http://wiki.wxwidgets.org/Microsoft_Visual_CPP_Guide\r
  30 \r
  31 There is a (sometimes) common problem with the cryptopp and zlib projects in the release and debug build, if some projects fail to link\r
  32 and give you a warning about redefined symbols, go to the properties on the cryptopp project, configuration "release" and change\r
  33 the "Configuration Properties"->"C/C++"->"Code generation"->"Runtime library" to "Multithreaded DLL (/MD)"\r
  34  in the release build or "Multithreaded Debug DLL (/MDd)" for the debug build. \r
  35 Do the same with zlib.\r
  36 \r
  37 If aMule fails to compile, here are some guidelines/patches to the most common problems:\r
  38 \r
  39 [*] If Scanner.cpp fails to compile, apply this change around line 1545:\r
  40 \r
  41 -        b->yy_is_interactive = file ? (isatty( fileno(file) ) > 0) : 0;\r
  42 +        b->yy_is_interactive = 0;\r
  43 \r
  44 if necessary.\r
  45 \r
  46 [*] The file muuli_wdr.cpp can also fail if it hasn't been patched for MSVC in the current code. The most common problem comes \r
  47 from this kind of lines:\r
  48 \r
  49         _("For a film you can say its length, its story, language ...\n"\r
  50           "and if it's a fake, you can tell that to other users of aMule."),\r
  51 \r
  52 Notice the opening and closing parentheses are on a different line, and the quotes opened again. While this is ok for gcc, Visual\r
  53 Studio won't allow it. Change this lines to be a single-line quoted text. In the above example, the result will be:\r
  54 \r
  55         _("For a film you can say its length, its story, language ...\nand if it's a fake, you can tell that to other users of aMule."),\r
  56 \r
  57 And that should be it. Feel free to ask in the aMule forum at forum.amule.org, "Compilation problems" section if you have further\r
  58 doubts.\r